SOURce<Ch>:POWer:CORRection

Note: The SOURce<Ch>:POWer... subsystem comprises port-specific and general settings. Port-specific settings are valid for the port specified by the numeric suffix <Pt> (...:POWER<Pt>:...). General settings are valid for all test ports of the analyzer; the port suffix is ignored. Refer to the description of the individual commands for more information.

SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire]
PORT | GENerator | A1 | A2 | A3 | A4 | ESRC1 | ESRC2[,<port_number>]

Selects the source for the source power calibration, starts and applies the source power calibration.

The command cannot be used unless a power meter is connected via GPIB bus, USB or LAN interface and configured in the External Power Meters dialog.

<Ch>	Calibrated channel number
<pt>	Calibrated port number. This suffix is ignored because the port number is specified in the parameter list.
PORT GENerator	Analyzer port is the source of the calibrated wave. External generator is the source of the calibrated wave. The port and generator numbers are specified by means of the <port_number> parameter.
A1 \| A2 \| A3 \| A4	Direct analyzer port selection. The parameters A1 and A2 are ZVR-compatible. No additional parameters need to be specified.
ESRC1 \| ESRC2	Direct external generator selection. The parameters are ZVR-compatible. No additional parameters need to be specified.
<port_number>	Analyzer port number of generator number, if PORT or GENerator is the first parameter.
Range [def. unit]	1 to port number of the analyzer/number of external generators [–]
*RST values	– (for all parameters)
SCPI, Command Types	Device-specific, no query
Example:	*RST; SOUR:POW:CORR:COLL:VER 0 Disable the verification sweep to speed up the source calibration procedure. SOUR:POW:CORR:OSO:STAT OFF To improve the accuracy, switch off all other sources during the calibration sweep. SOUR:POW:CORR:NRE 2; COLL:AVER:NTOL 0.5 Increase the number of readings and reduce the power tolerance to improve the accuracy. SOUR:POW:CORR:ACQ PORT,1 Perform a source power calibration using port 1 as a source port. SOUR:POW:CORR? Check whether the calibration is applied (the response is 1). Change the test setup, connect an external generator no. 1 to the reference plane. SOUR:POW:CORR:ACQ GEN,1 Perform a source power calibration the external generator no. 1 as a source. SOUR:POW:CORR:GEN? Check whether the calibration is applied (the response is 1).

SOURce<Ch>:POWer<Pt>:CORRection:COLLect[:ACQuire]
ASENsor | BSENsor

Initiates a source power calibration for the source port <pt> using an external power meter no. 1 or 2. To initiate a source power calibration for arbitrary power meters, use the alternative commands listed in the program example below.

The command cannot be used unless a power meter is connected via GPIB bus, USB or LAN interface and configured in the External Power Meters dialog.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number.
ASENsor \| BSENsor	External power meter Pmtr 1 External power meter Pmtr 2
*RST value	ASENsor
SCPI, Command Types	Device-specific, no query
Example:	SOUR:POW3:CORR:COLL BSEN Perform a source power calibration for port 3 using power meter no. 2. SOUR:POW:CORR:PMET:ID 2, Select power meter no. 2. SOUR:POW:CORR:ACQ PORT,3 Perform a source power calibration for port 3 using the previously selected power meter no. 2.

SOURce<Ch>:POWer<Pt>:CORRection:COLLect[:ACQuire]:VERification[:STATe] <Boolean>

Enables or disables a verification sweep that the analyzer performs after the source power calibration. The command is valid for all ports and external generators

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the verification is either enabled or disabled for all sources.
<Boolean>	Enables (ON) or disables (OFF) the verification sweep.
*RST value	ON
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:COLLect:AVERage[:COUNt] <readings>

Sets a limit for the number of calibration sweeps in the source power calibration. The command is valid for all ports and external generators. Equivalent command: SOURce<Ch>:POWer<Pt>:CORRection:NREadings.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the verification is either enabled or disabled for all sources.
<readings>	Number of readings
Range [def. unit]	1 to 100 [–]
*RST value	1
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire] (for equivalent command SOURce<Ch>:POWer<Pt>:CORRection:NREadings).

SOURce<Ch>:POWer<Pt>:CORRection:COLLect:AVERage:NTOLerance <tolerance>

Specifies the maximum deviation of the measured power from the target power of the calibration.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the tolerance value is valid for all sources.
<tolerance>	Tolerance value
Range [def. unit]	0.001 dB to 1000 dB [dB]
*RST value	1 dB
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:DATA
'<src_string>', <block> | <numeric_value>...

Reads or writes source power correction data sets. A power correction data set contains n real values where:

Each value corresponds to the ratio of the actual power at the reference plane (value provided by the used source) to the uncalibrated power in dB.
The number n is equal to the number of sweep points.

Increasing (decreasing) the values in the correction data sets increases (decreases) the power at the reference plane. Writing correction data (the setting command) fails if the number of transferred values is not equal to the number of sweep points.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number
'<src_string>'	Identifier for the source of the calibrated wave: 'A<n>' or 'PORT<n>' denote correction data for the analyzer port no. <n>. 'ESRC<n>' or 'GEN<n>' denote correction data for the external generator no. <n>.
<block> \| <numeric_value>...	Power correction values in block data format or as a comma-separated list of real numbers. The query returns a list of numbers.
Range [def. unit]	All numbers are interpreted as dB-values.
*RST value	–
SCPI, Command Types	Device-specific, command or query
Example:	*RST; :SWE:POIN 10 Reset the instrument and reduce the number of sweep points to 10. SOUR:POW:CORR:ACQ PORT,1 Perform a source power calibration using port 1 as a source port. SOUR:POW:CORR:DATA? 'A1' Query the correction values. The analyzer returns 10 comma-separated real numbers. SOUR:POW:CORR:DATA? 'A1', 1, 2, 3, 4, 5, -6, -7, -8, -9, -0 Replace the correction values by ten (new) numbers.

SOURce<Ch>:POWer<Pt>:CORRection:GENerator[:STATe] <Boolean>

Enables or disables the source power calibration for channel <Ch> and for an external generator number <Pt>. The command is disabled unless a source power calibration for the external generator has been performed (SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire]). To enable or disable a source power calibration for an analyzer port use SOURce<Ch>:POWer<Pt>:CORRection[:STATe].

<Ch>	Calibrated channel number
<Pt>	Calibrated external generator
<Boolean>	Enables (ON) or disables (OFF) the source power calibration for port number <Pt>.
*RST value	OFF [–]
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:LEVel:OFFSet <numeric_value>

Specifies a gain (positive values) or an attenuation (negative values) in the signal path between the source port and the calibrated reference plane. The value has no impact on the source power.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the level offset is valid for all sources.
<tolerance>	Tolerance value
Range [def. unit]	–300 dB to +300 dB [dB]
*RST value	0 dB
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:MIXer:LO[:ACQuire]

Starts the LO source calibration (3rd power calibration step for mixer measurements), stores and applies the calibration data. The external power meter is selected via SOURce<Ch>:POWer<Pt>:CORRection:PMETer:ID.

The LO source calibration is independent of the RF source and IF receiver calibration; see description of the mixer calibration procedure.

<Ch>	Calibrated channel number
<pt>	Calibrated port number. This suffix is ignored; the port is selected via [SENSe<Ch>:]FREQuency:CONVersion:MIXer:LOINternal or [SENSe<Ch>:]FREQuency:CONVersion:MIXer:LOEXternal.
SCPI, Command Types	Device-specific, no query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection:MIXer:RF[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:MIXer:RF[:ACQuire]

Starts the RF source calibration (1st power calibration step for mixer measurements), stores and applies the calibration data. The external power meter used is selected via SOURce<Ch>:POWer<Pt>:CORRection:PMETer:ID.

The command initiates two calibration steps, the first at the RF frequency range, the second at the IF frequency (for a subsequent receiver power calibration, [SENSe<Ch>:]CORRection:POWer<port_no>:MIXer:IF:ACQuire). See description of the mixer calibration procedure.

<Ch>	Calibrated channel number
<pt>	Calibrated port number. This suffix is ignored because the RF signal is always assigned to port 1.
SCPI, Command Types	Device-specific, no query
Example:	Set up a mixer measurement; see e.g. example for [SENSe<Ch>:]FREQuency:CONVersion:MIXer:TFRequency. SOUR:POW:CORR:PMET:ID 1 Select power meter no. 1 (previously configured in the External Power Meters dialog and properly connected) for the RF source calibration. SOUR:POW:CORR:MIX:RF Start the RF source calibration. Change the test setup for the IF receiver calibration (see mixer calibration procedure). CORR:POWer:MIX:IF:ACQuire Start the IF receiver calibration. FREQ:CONV:MIX:LOIN 3 Select port no. 3 as a signal source for the LO signal. Adjust the test setup for the LO source calibration. SOUR:POW:CORR:MIX:LO Start the LO source calibration.

SOURce<Ch>:POWer<Pt>:CORRection:NREadings <readings>

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the verification is either enabled or disabled for all sources.
<readings>	Number of readings
Range [def. unit]	1 to 100 [–]
*RST value	1
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:OSOurces[:STATe] <Boolean>

Switches off all other sources during the calibration sweep for channel <Ch>.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the setting is valid for all sources.
<Boolean>	ON – Other sources not necessarily switched off OFF – Other sources switched off during the calibration sweep
*RST value	ON [–]
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection:PMETer:ID <pmeter_no>

Selects an external power meter for the source power calibration.

The command cannot be used unless a power meter is connected via GPIB bus, USB or LAN interface and configured in the External Power Meters dialog.

<Ch>	Calibrated channel number
<Pt>	Calibrated port number. This parameter is ignored; the power meter selection is valid for all sources.
<pmeter_no>	Number of external power meter. The parameters UP, DOWN, MIN, MAX are not available for this command.
Range [def. unit]	1 to number of external generators [–]
*RST value	The power meter selection is not changed by a reset of the analyzer.
SCPI, Command Types	Device-specific, command or query.
Example:	See SOURce<Ch>:POWer<Pt>:CORRection:COLLect[:ACQuire] and SOURce<Ch>:POWer<Pt>:CORRection:MIXer:RF[:ACQuire].

SOURce<Ch>:POWer<Pt>:CORRection[:STATe] <Boolean>

Enables or disables the source power calibration for channel <Ch> and for port number <Pt>. The command is disabled unless a source power calibration for the analyzer port has been performed (SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire]). To enable or disable a source power calibration for an external generator use SOURce<Ch>:POWer<Pt>:CORRection:GENerator[:STATe].

<Ch>	Calibrated channel number
<Pt>	Calibrated port number
<Boolean>	Enables (ON) or disables (OFF) the source power calibration for port number <Pt>.
*RST value	OFF [–]
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:CORRection[:ACQuire].